revLoadedStacks
Type
function
Summary
Returns a list of the names of all stacks that are loaded into memory.
Syntax
revLoadedStacks([<whichStacks>])
Description
Use the revLoadedStacks function if you need to perform some operation on all stacks that are loaded into memory.
If the whichStacks parameter is all, the revLoadedStacks function returns all stacks that are loaded into memory, including stacks that are part of the LiveCode development environment (such as the message box, property inspector, and so on).
If the whichStacks parameter is application, the revLoadedStacks function returns all loaded stacks that are not part of the development environment.
If the whichStacks parameter is preference, the revLoadedStacks function checks the setting of the "LiveCode UI Elements in Lists" item in the View menu, and returns either all stacks, or only stacks that are not part of the development environment, depending on the setting.
If you don't specify a whichStacks parameter, the revLoadedStacks function returns all loaded stacks that are not part of the development environment. This is the same behavior as if application had been specified as the whichStacks parameter.
When included in a standalone application, the Common library is implemented as a hidden group and made available when the group receives its first openBackground message. During the first part of the application's startup process, before this message is sent, the revLoadedStacks function is not yet available. This may affect attempts to use this function in startup, preOpenStack, openStack, or preOpenCard handlers in the main stack. Once the application has finished starting up, the library is available and the revLoadedStacks function can be used in any handler.
Parameters
| Name | Type | Description |
|---|---|---|
whichStacks |
|
Examples
revLoadedStacks(all)
revLoadedStacks(application)
revLoadedStacks()
Related
library: Common library, library
message: startup, openBackground, preOpenStack, openStack, preOpenCard
control structure: function
function: stacks, mainStacks
glossary: return, loaded into memory, main stack, handler, development environment, message, group, standalone application, parameter, property inspector, application
keyword: message box
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
Platforms
desktop
server